home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / prevent.arc / PREVENT.DOC < prev    next >
Text File  |  1990-05-09  |  3KB  |  69 lines
  1.  
  2.  
  3. PREvent 1.00
  4. PCBoard Rotary Event Manager
  5. ___________________________________________________________________
  6.  
  7.  
  8. With the release of PCBoard 14.5, I found my multiple event program
  9. trashed, and my need for multiple events still existing.    It was a
  10. two hour job to write this, so I hereby dedicate PREvent to the
  11. public domain.   If your conscience bothers you so much that you can't
  12. use a program without paying for it, give Telix a plug to a friend.
  13.  
  14. PRevent is very simple and straightforward.   It uses a data file to
  15. read in a list of your event times in chronological order, and matches
  16. them against PCBoard.DAT to determine the next time.
  17.  
  18. This file, PREVENT.LST is simple.   The first line is the number of
  19. events you wish to run, and the remaining lines are those of the event
  20. times.   For example, I have three events, one at just before midnight,
  21. one at 2:30 am, and one at 4:00 am.   My PREVENT.LST file looks like
  22. this (and is the same as the one included here):
  23.  
  24. 3
  25. 02:30
  26. 04:00
  27. 23:57
  28.  
  29. Note that order is important.   The order MUST be chronological,
  30. starting with 00:02 (the earliest possible event time) and ending with
  31. the latest, 23:58.   All times must be in military format.   The .LST
  32. file may contain up to 48 differenct event times.   Place this file in
  33. your PCBoard system directory, the same one where PCBoard.DAT resides.
  34. This is usually something like D:\PCB.
  35.  
  36. Place PREVENT.EXE in your PCBoard system directory also.   No parameters
  37. are required to run PREvent.   Just include the command:
  38.  
  39. PREVENT
  40.  
  41. in your EVENT.SYS and off it goes.
  42.  
  43. PREvent returns an error level based on the event it runs.  In the above
  44. example, the 2:30 event returns an errorlevel of 1 when exiting, the
  45. 4:00 event returns errorlevel 2, and the 23:57 returns 3.   Any error
  46. returns errorlevel 0.   You can use these errorlevels in your EVENT.SYS
  47. file to take the appropriate action.   Thus, if errorlevel 1 is
  48. returned, you know that the 2:30 event was just placed into PCBoard.DAT,
  49. thus the event you want to run is the one at 23:57, and can call the
  50. according batch file.   I hope that's not too confusing.
  51.  
  52. PREvent works ONLY on PCBoard 14.5.   Any attempt to use it on earlier
  53. version are not warranted.   It should not change anything in such a
  54. case and will return an error level of zero, but no guarantees.
  55.  
  56. And now for the legal, boring stuff.   I left it until the end, so if
  57. you don't care to read this, oh, well.   It was here.
  58.  
  59. Jeff Woods nor the Musical Chair warrants any part of this program.   It
  60. is provided free, and as such, any damages it may cause to files,
  61. hardware, or incidental damages such as lost time or wages, are not my
  62. responsibility.   Or, in short, I cannot behelp responsible for any
  63. damages resulting from the use (or mis-use) of this program.
  64.  
  65. As with all software, you should backup your PCBoard.DAT file before
  66. trying this the first time.   The latest version is always available for
  67. downloading from the Musical Chair at 816-561-3006, running an HST Dual
  68. Standard.
  69.